home *** CD-ROM | disk | FTP | other *** search
/ PC Plus SuperCD (UK) 1997 May / PC Plus Super CD Issue 127 (May 1997).iso / vcafe / _setup.lib / README.TXT < prev    next >
Encoding:
Text File  |  1996-01-11  |  12.0 KB  |  324 lines
  1. README for Symantec CafΘ Lite
  2. ============================================================
  3. Copyright (c) 1996 by Symantec Corporation. All Rights Reserved.
  4.  
  5.  
  6. ABOUT THE "README.TXT" FILE
  7. ============================================================
  8. This file, "readme.txt," provides essential information on 
  9. installing and using Symantec CafΘ Lite.
  10.  
  11. The sections that follow provide information on
  12.  
  13. * What Symantec CafΘ Lite includes
  14.  
  15. * What you need
  16.  
  17. * Installing Symantec CafΘ Lite
  18.  
  19. * Building and Using Java Projects
  20.  
  21. * Important Points, Tips, and Workarounds
  22.  
  23. * Documentation
  24.  
  25. * Where to Go from Here
  26.  
  27. * Differences between Java Beta 1 and Beta 2
  28.  
  29.  
  30. WHAT IS SYMANTEC CAF╔ LITE ?
  31. ============================================================
  32.  
  33. Symantec CafΘ Lite is a set of tools that allow Windows developers 
  34. to edit, build, run, and debug Java applications within the Symantec 
  35. Integrated Development and Debugging Environment, under Windows 95 
  36. and Windows NT.  This version supports Sun's Java Release Beta 2.
  37.  
  38. Symantec CafΘ Lite includes instant creation of Java applets and 
  39. Java applications using AppExpress, and features advanced editing 
  40. and project management capabilities for Java development.
  41.  
  42. This is a special early-release version of the product.
  43. Please read the limitations in "Important Points, Tips, and 
  44. Workarounds" below, and send any comments you have, or requests 
  45. for more information, to javainfo@symantec.com.
  46.  
  47.  
  48. WHAT YOU NEED
  49. ============================================================
  50.  
  51. * An IBM Personal Computer or 100 percent compatible
  52.  
  53. * 16MB RAM
  54.  
  55. * Windows 95 or Windows NT 3.51
  56.  
  57. * CD ROM Drive
  58.  
  59. * 25 MB free hard disk space
  60.  
  61.  
  62. INSTALLING SYMANTEC CAF╔ LITE
  63. ============================================================
  64.  
  65. 1. Insert the CD-ROM in the CD-ROM Drive on your system.
  66.  
  67. 2. Choose Run from the Windows start Menu to display the Run dialog.
  68.  
  69. 3. type:
  70. [d]:\setup.exe 
  71. where [d] is the CD-ROM drive identifier, and click on OK.
  72.  
  73. 4. Follow the instructions on the screen and click on Next to proceed.
  74.  
  75. 5. Select the directory in which you want to install.  If you do not 
  76. specify another location the installer will install Symantec CafΘ Lite 
  77. into C:\CafΘ.
  78.  
  79. 6. Click on Next.  The installer will then install Symantec CafΘ Lite 
  80. on your hard drive. This will take from 2 to 8 minutes depending on 
  81. the speed of your computer and CD-ROM Drive.
  82.  
  83. 7. When the installation is complete, you will see a dialog box that 
  84. will allow you to restart your computer. Click on OK to restart and 
  85. allow the necessary changes to take effect.
  86.  
  87. Note:
  88. To uninstall Symantec CafΘ Lite, you can use the Windows 95
  89. Add/Remove programs control panel, or under NT launch the 
  90. uninstall icon in the Symantec CafΘ Group.
  91.  
  92.  
  93. BUILDING AND USING JAVA PROJECTS
  94. ============================================================
  95.  
  96. We suggest that you start by using and examining one of the demo 
  97. projects. The section below discusses how to start by using the 
  98. ArcTest demo. Later you can use AppExpress to generate new Java 
  99. applications, or generate projects manually.
  100.  
  101. Using the Java Demos
  102. ------------------------------------------------------------
  103. Launch Symantec CafΘ Lite
  104. Under Windows 95 you can launch Symantec CafΘ Lite from the
  105. Start | Programs menu. 
  106.  
  107. Open Project 
  108. You'll see the Symantec CafΘ startup screen. Open the ArcTest demo 
  109. project, located in CafΘ\java\demo\ArcTest and named arctest.prj.  
  110.  
  111. Choose Build
  112. You will notice a brief delay as the Java compiler is invoked and 
  113. processes the ArcTest.java source file. The compiler will produce 
  114. the runtime class file ArcTest.class and some additional classes 
  115. in the ArcTest directory.
  116.  
  117. Choose Execute Program
  118. After a brief pause, the ArcTest applet will appear and run.
  119.  
  120. Note:
  121. The first time you a run a Java application after installing, you will 
  122. see a copyright notice from SUN Computer. To accept the terms and use 
  123. the Java software on your computer, click on Accept. 
  124.  
  125. Choose Project Arguments...
  126. Applets are invoked by running appletviewer.exe on the HTML text file 
  127. specified in the Project | Arguments dialog. Choose this to see that 
  128. the file run by the IDDE is named example1.html. You can specify 
  129. another HTML file to run instead, such as example2.html.  If you are 
  130. interested, you can open example1.html in the editor to see the 
  131. format for invoking an applet from an HTML file.
  132.  
  133.  
  134. Using AppExpress
  135. ------------------------------------------------------------
  136. In Symantec CafΘ Lite, AppExpress offers three application types: 
  137. Java Applet, Java SDI, and Java Console.  These are extremely 
  138. simple examples to demonstrate Java applications.
  139.  
  140. This is how to create new simple Java projects using AppExpress:
  141.  
  142. 1. Select the menu item Project|New. DO NOT alter or fill in 
  143. the project name. Select a directory, check 'Use AppExpress' 
  144. and click Finish.
  145.  
  146. 2. In The AppExpress main dialog select one of the three Java 
  147. application types and click Finish. (Don't change the project name 
  148. on the Miscellaneous dialog.)
  149.  
  150. 3. Build and execute program as usual.
  151.  
  152. Please note the following limitation:
  153.  
  154. In Symantec CafΘ Lite, the AppExpress names are all preassigned, and 
  155. everything has the same name: "Simple." (The file Simple.java contains 
  156. the class Simple, and the project file is Simple.prj.) 
  157.  
  158. Note: If you assign your own project name to one of these sample Java 
  159. projects, it will generate and build, but Project | Execute Program 
  160. won't work. If you want to name your project something else, you can, 
  161. but then you must change the following occurrences of "Simple" to be 
  162. exactly the same as your project name, including case-matching: 
  163.     for all:
  164.         - Simple.java  (rename the file)
  165.         - class Simple inside Simple.java
  166.     for Java SDI add:
  167.         - constructor for class Simple inside Simple.java
  168.     for Java Applet add:
  169.         - APPLET CODE="Simple.class" inside Simple.html 
  170.        then EITHER
  171.         - Simple.html (rename the file)
  172.            OR
  173.         - change "<projname>.html" in Project Arguments
  174.  
  175. In the case of a Java applet, what the idde executes is based on the
  176. project arguments, not the project name as in all other cases.
  177.  
  178. See further discussion of applets below.
  179.  
  180.  
  181. Generating New Projects Manually
  182. ------------------------------------------------------------
  183. If you have existing Java source code, you can use ProjectExpress 
  184. to generate your own projects manually; just specify either Applet 
  185. or Console. Console apps are Java stand-alone, i.e., "non-applet," 
  186. runnable components.
  187.  
  188. The Java source files (.java) contain the source code for your Java 
  189. classes. At build time, the compiler produces a Java class file 
  190. (.class) with the same basename as the source file. 
  191.  
  192. When you choose Execute Program for a Java Console app, the IDDE runs 
  193. the Java interpreter on a class with the same name as your project.
  194.  
  195. Java applets, in contrast to console applications, are called from 
  196. Hypertext links, for example from links in internet Web pages. The 
  197. links are written in an editable text file using the Hypertext Markup 
  198. Language (HTML).  
  199.  
  200. Applet projects require you to write the HTML file to invoke your 
  201. applet.  See the demo projects for examples.
  202.  
  203. The .html file supplies the link that allows your JAVA applet to be 
  204. launched and debugged within the Symantec IDDE. You specify the name 
  205. of the HTML file to be run in the "Project | Arguments" menu choice 
  206. in the Symantec CafΘ Lite environment.
  207.  
  208.  
  209. IMPORTANT POINTS, LIMITATIONS, TIPS, AND WORKAROUNDS
  210. ============================================================
  211. Symantec CafΘ Lite requires you to run under either Windows 95 or 
  212. Windows NT 3.51.
  213.  
  214. File names and class names must be identical in spelling and 
  215. CAPITALIZATION.  This is a requirement of the Java compiler and 
  216. interpreter.
  217.  
  218. If the project is of type Applet, the Symantec Environment runs 
  219. appletviewer on the .html file that is specified in the Project 
  220. Arguments dialog; otherwise it runs the Java interpreter on the
  221. .class file which has the same basename as the current project.
  222.  
  223. The applet class specified in the HTML file must be capitalized 
  224. exactly the same as the class name in the .java file.
  225.  
  226. There is currently no graphical debugger for Java. When you choose
  227. "Start/Restart Debugging" the IDDE launches the Sun command-line 
  228. debugger.
  229.  
  230. If you attempt to debug, you MUST have TCP/IP installed.  
  231. If not, the Sun command-line debugger will hang.
  232.  
  233. Symantec CafΘ Lite projects must not have names containing spaces.
  234.  
  235. The Java compiler currently will not run from a WIN95 shared drive.  
  236. The symptom is the same as if CLASSPATH were not set (i.e., compiler 
  237. complains that it can't find the classes). This problem is under 
  238. investigation and we hope to have a fix soon.  Symantec CafΘ Lite 
  239. can be run from a Netware volume.
  240.  
  241. Some of the Sun Demo programs using sound are not well behaved if 
  242. you are running a machine that does not have a sound card.  You may 
  243. have to use Cntl-Alt-Delete to terminate a misbehaving java applet 
  244. if this happens.
  245.  
  246.  
  247. AppExpress
  248. ------------------------------------------------------------
  249. The Java SDI sample is not fully functional. Only the menu items 
  250. Help | About and File | Exit have code behind them.
  251.  
  252.  
  253. Compiler support
  254. ------------------------------------------------------------
  255. The compiler does not accurately report the number of lines compiled.
  256.  
  257. Certain Java compiler switches are not currently supported in the IDDE.
  258. For more information you may want to run the java compiler, javac.exe,
  259. directly from the command line.
  260.  
  261.  
  262. Earlier versions of Java
  263. ------------------------------------------------------------
  264. Earlier Java releases from Sun have different class names and 
  265. functionality in comparison with the current release. For more 
  266. information please refer to Sun's http site at http:\\java.sun.com.
  267.  
  268.  
  269. DOCUMENTATION
  270. ============================================================
  271. The folder Sun Doc contains the latest Java documentation available 
  272. from Sun when this CD was mastered.  The latest Java documentation 
  273. is always available at Sun's web site.
  274.  
  275. Most of the files are in HTML and can be viewed with your favorite 
  276. browser, such as CyberJack or NetScape.  This includes the current 
  277. API and Programmer's Guide.  The Java Language specification is 
  278. provided as a postscript file. It can be printed on any PostScript 
  279. printer or viewed with utilities such as GhostScript.
  280.  
  281.  
  282. WHERE TO GO FROM HERE
  283. ============================================================
  284. There is a host of information available at http:\\java.sun.com.
  285.  
  286. The Symantec World Wide Web site is located at www.symantec.com.
  287.  
  288. For additional information about Symantec Java support, please 
  289. contact javainfo@Symantec.com.
  290.  
  291. For Java development, a good book to start with is Arthur van Hoff's 
  292. "Hooked on Java", Addison Wesley, ISBN 0-201-48837-X.
  293.  
  294.  
  295. DIFFERENCES BETWEEN SUN JAVA BETA1 AND BETA 2
  296. ============================================================
  297. Symantec CafΘ Lite supports Sun's Java beta 2 release including the 
  298. final Java 1.0 API. This API is compatible with Netscape 2.0 Beta 4 
  299. and later versions.
  300.  
  301. There is now an empty finalize() method in Object.
  302.  
  303. The definition of clone in Object is now as follows:
  304. protected native Object clone() throws CloneNotSupportedException;
  305. Thus if a class has not implemented the interface Clonable, a call 
  306. to clone will fail and give the error CloneNotSupportedException.
  307.  
  308. Errors previously reported as warnings are now errors, and must be 
  309. handled in your code.
  310.  
  311. The meaning of the 'protected' modifier has changed slightly.
  312.  
  313. Contravariant return types are not supported. Overriding methods 
  314. must have the same return type as the overridden method.
  315.  
  316. Loading classes from zip files is now supported by both the compiler
  317. and the runtime class loader.
  318.  
  319. There have been several bug fixes, security improvements and API
  320. changes since the BETA 1 release.
  321.  
  322. All of these changes are described more completely at Sun's web site:
  323. http//java.sun.com/JDK-beta2/changes.html.
  324.